home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / RECOLOR.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  46 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _ReColor( nFRow, nFCol, nTRow, nTCol, cColor) --> NIL
  8.  
  9. PARAMETERS:
  10.  
  11. nFRow   : Screen area coordinates
  12. nFCol   : ""
  13. nTRow   : ""
  14. nTCol   : ""
  15. cColor  : Color to rewrite region in
  16.  
  17. SHORT:
  18.  
  19. Rewrite screen region in different color, leaving text intact.
  20.  
  21. DESCRIPTION:
  22.  
  23. _ReColor() redraws a screen region in a different color leaving the text
  24. there intact.
  25.  
  26. Since the only "default" color would be the current color, there is not
  27. much sense in not specifying it.  However, if cString is not specified,
  28. the default is in fact the current color setting.
  29.  
  30. If any of the screen area coordinates are not specified, the function
  31. does nothing and immediately returns NIL.
  32.  
  33. NOTE:
  34.  
  35. This function is the opposite of _ColorSay() which writes text on the
  36. screen in the colors already there.
  37.  
  38. EXAMPLE:
  39.  
  40. _ReColor(5,10,7,40,"W*+/R")
  41.  
  42. Result: Whatever is currently in the area of the screen at the given
  43. coordinates is rewritten in blinking high white on a red background.
  44.  
  45. ******************************************************************************/
  46.